home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / showfr12.zip / README.DOC < prev    next >
Text File  |  1993-06-19  |  14KB  |  303 lines
  1.                    System Availability Analysis - SHOWFREE
  2.                    ---------------------------------------
  3.  
  4. Copyright 1993 Clark Development Company, Inc.
  5.  
  6.  
  7. Description
  8. ===========
  9. The program contained herein, called SHOWFREE, is unlike many of the ordinary
  10. system usage analysis programs available for PCBoard BBS's.  Instead of trying
  11. to analyze HOW MUCH your system is used (which is something that is important
  12. for the sysop to know) it focuses instead on HOW FREE your system is (which is
  13. something a potential caller would want to know).
  14.  
  15. Here is an example of the difference in thinking behind the two different
  16. system analysis schemes:
  17.  
  18.   Given the following:       3 nodes running in rotary on a single phone line
  19.                              Node #1 is busy for an entire hour
  20.                              Node #2 is busy for 30 minutes of this hour
  21.                              Node #3 never gets a call this hour
  22.  
  23.   How much system is used:   Utilization is 90 minutes spread across 3 nodes.
  24.                              Some analysis programs will show this as being
  25.                              50% utilization because there were 180 system
  26.                              minutes available but only 90 were used.
  27.  
  28.   How free is the system:    The system is 100 percent free!!!  Because there
  29.                              were NO calls that rolled down to node 3 (from
  30.                              nodes 1 and 2) there was NEVER a time that a
  31.                              caller would have received a busy signal.  To
  32.                              the caller - the system was 100% free that hour.
  33.  
  34. So while the system usage analysis showed 50% usage, something the sysop needs
  35. to consider when trying to decide if his system is being properly utilized,
  36. the system availability analysis instead showed that the system was 100%
  37. available.
  38.  
  39. Here again, this data can be important to the sysop.  If the system
  40. availability drops below 50% then the sysop should realize that half the time
  41. the system is up the callers are getting BUSY SIGNALS and a new phone line may
  42. be needed.
  43.  
  44. Let's do one more example just to make sure we understand the difference:
  45.  
  46.   Given the following:       3 nodes running in rotary on a single phone line
  47.                              Node #1 is busy from 1:00 to 1:50
  48.                              Node #2 is busy from 1:20 to 1:45
  49.                              Node #3 is busy from 1:15 to 2:00
  50.  
  51.   How much system is used:   Utilization is 120 minutes spread across 3 nodes.
  52.                              Some analysis programs will show this as being
  53.                              67% utilization because there were 180 system
  54.                              minutes available and 120 of them were used.
  55.  
  56.   How free is the system:    The system has 20 minutes, from 1:00 to 1:20,
  57.                              when there is at least one node free.  Then from
  58.                              1:45 to 2:00 there are another 15 minutes free.
  59.                              All told, there were 35 minutes out of the hour
  60.                              when a caller could have connected without a
  61.                              busy signal.  That makes the system availability
  62.                              58 percent for that hour.
  63.  
  64. Program Requirements
  65. ====================
  66. This program will ONLY work properly given the following requirements:
  67.  
  68.    - A given CALLER log contains at most 24 hours worth of entries
  69.    - If an event is identified to the system it is assumed that all nodes
  70.      in a group will be down for the same period of time for the event
  71.    - Multiple nodes on a single rotary or ring-down are grouped together
  72.  
  73. This program saves a history of system availability and averages everything
  74. together.  Therefore it does not need to have more than one day's worth of
  75. information in the CALLER log and in fact putting more than one day's worth
  76. of information into the file can cause errors in the calculations.
  77.  
  78. It is therefore recommended that you delete your CALLER logs once a day.  If
  79. you have other software that needs to use more than one day's worth of
  80. information then you can append each day's log to the master log like this:
  81.  
  82.          COPY \KEEP\CALLER1 + CALLER1 \KEEP\CALLER1
  83.  
  84. The above line would add CALLER1 onto the end of \KEEP\CALLER1.
  85.  
  86.  
  87. Line Groups
  88. ===========
  89. This program will work fine on a single node system.  However, the analysis
  90. of system availability is easily predictable as the reciprocal of a system
  91. usage analysis.  In other words, if the system is 25% used then it is 75%
  92. free.
  93.  
  94. Where this program really shines is when determining the system availability
  95. across multiple nodes in a single line group.  By that, I mean, if you have
  96. had Ma Bell set you up with 5 phone lines and 3 of them ring in rotary for
  97. a set of HST modems, for example, and the other two ring in rotary for a set
  98. of Hayes V-Series modems - then you have a very obvious separation of two
  99. line groups.  One for HSTs and another for V-Series.
  100.  
  101. To make this easier...  if a caller can dial ONE PHONE NUMBER and reach more
  102. than one node - then all of the nodes that he can reach are in the same group.
  103.  
  104.  
  105. Program Installation and Usage
  106. ==============================
  107. This program is pretty easy to install.  Just make a \PCB\SHOW directory in
  108. which to run the program in (any unique subdirectory will do).  Copy all of
  109. the files into that directory.  Your EVENT.SYS file will then contain a
  110. line such as this:
  111.  
  112.       showfree showfree.cnf
  113.  
  114. The above line will create a file which you can then use as a bulletin on your
  115. system.  The format of the SHOWFREE.CNF is as follows:
  116.  
  117. ------------------------------------------------------------------------------
  118. C:\PCB\MAIN\CALLER                          # name/loc of caller logs
  119. 1-4 7-9 11                                  # node numbers to process
  120. SHOWFREE.RPT                                # name of report file
  121. SHOWFREE.SAV                                # name of average history file
  122. 02:00-02:30                                 # event start thru event end times
  123. # everything below this line is a "header" for the report file
  124. @CLS@@X0FPHONE: 801-261-8977  (nodes 1, 2, 3, 4, 7, 8, 9, 11)
  125. @X0B
  126.                            System Availability Graph
  127.                    (chances of getting through on first call)
  128. ------------------------------------------------------------------------------
  129.  
  130. The first 2 lines of the above identify where the caller logs are to be found
  131. and which node numbers to put into a group.  You can list each node number
  132. separately as in "1 2 3 4 5" or you can use a dash as in "1-5" to mean the
  133. same thing.  Spaces must be used as number separators.  Commas cannot be used.
  134.  
  135. The next line defines the name of the report file (or bulletin if you want to
  136. have the file immediately posted as a bulletin).
  137.  
  138. The next line defines the name of the history file to be used.  If you are
  139. using multiple groups then it is recommended that each group have its own
  140. history file.
  141.  
  142. The next line defines the time of the event.  It is not necessary to list an
  143. event and in fact the line can be left blank.  If an event is specified it is
  144. assumed that all nodes within the group will be down for the period of time
  145. shown for the event.
  146.  
  147. The seventh and all subsequent lines are the report header.  You can put
  148. anything you want and make the rest of the file as long or as wide as you
  149. wish.  The only rule is:  make it readable for your callers.
  150.  
  151.  
  152. Version 15.0 Additions
  153. ======================
  154. PCBoard v15.0 offers the ability to monitor missed connections.  There are
  155. three possible types of "missed connections" that are reported in the callers
  156. log.  They are:
  157.  
  158.    NO CONNECT/NO CARRIER     - indicates a ring was detected, but the modem
  159.                                reported NO CARRIER during the countdown
  160.                                sequence before a connection was made
  161.  
  162.    NO CONNECT/FULL COUNTDOWN - indicates a ring was detected, but that the
  163.                                system counted all the way down without a
  164.                                connection ever having been established
  165.  
  166.    Carrier Lost              - if carrier lost shows up in between calls
  167.                                without a caller name to show logon/logoff then
  168.                                this indicates that a connection was established
  169.                                but that the caller lost carrier before typing
  170.                                in a name.
  171.  
  172. In order to make use of these values, however, you MUST modify your PCBTEXT
  173. file.  The following commands can be used to make the modifications:
  174.  
  175.     MKPCBTXT C:\PCB\GEN\PCBTEXT /I:34  "@SYSTIME@ NO CONNECT/@OPTEXT@"
  176.     MKPCBTXT C:\PCB\GEN\PCBTEXT /I:215 "@SYSTIME@ Carrier Lost ..."
  177.  
  178. These two changes put the TIME of the occurance into the log so that SHOWFREE
  179. can track when the problem occur.
  180.  
  181. Finally, you must go to PCBSetup : Modem Information : Configuration Switches
  182. and answer 'Y' to the question "Monitor Missed Connections" in order to enable
  183. the above lines in your callers log.
  184.  
  185.  
  186. Analysis Reports
  187. ================
  188. The output files created by SHOWFREE make extensive use of PCBoard v14.5's
  189. color @X codes.  This means that a single file can be viewed by graphics
  190. and non-graphics callers alike.  Of course, the graphics callers will find
  191. the file much more readable due to the advantage of color "cues" in reading
  192. the graph.
  193.  
  194.  
  195. Event Times
  196. ===========
  197. Let me give an example in the way of explanation for the need for entering
  198. your event time into the configuration file:
  199.  
  200.     fact 1:  system event starts at 2:00am
  201.     fact 2:  system event ends at 2:30am
  202.     fact 3:  all caller logs are deleted during the event
  203.  
  204. Given the above information you will be missing information in the caller logs
  205. that would give the SHOWFREE program knowledge that the system was unavailable
  206. from 2:00am until 2:30am.  The system availability analysis would, therefore,
  207. incorrectly show the time from 2:00-2:30 as being AVAILABLE when in fact it
  208. is not.
  209.  
  210. If you run multiple events you most likely do NOT delete the callers logs in
  211. each one.  Therefore there is no need to list each event.  Just the event that
  212. deletes any trace of itself by deleting the caller logs needs to be shown.
  213.  
  214.  
  215. Advanced Ideas
  216. ==============
  217. One phone line can actually participate in more than one line group.  For
  218. example, the Salt Air BBS has only two really distinct groups.  They are:
  219.  
  220.          801-261-8976   HST modems   - nodes 1, 2, 3, 7, 8, 9
  221.          801-261-8979   Hayes modems - nodes 5, 6
  222.  
  223. However, we have two phone lines that are private and cost more to access.  We
  224. call them our Extended Support lines.  These two lines participate in the same
  225. ring down used by the HST modems making the following true:
  226.  
  227.          801-261-8977   Extended Support - nodes 1, 2, 3, 4, 7, 8, 9, 11
  228.  
  229. Because two additional nodes are in the group the system availability for this
  230. particular group is higher than the system availability of the HST group.
  231. That is because with more lines to dial into there is a greater chance that
  232. one of them will be free and waiting for a phone call.
  233.  
  234. The Salt Air system, therefore, runs the SHOWFREE program three separate
  235. times like this:
  236.  
  237.    showfree hstnodes.cnf
  238.    showfree private.cnf
  239.    showfree node56.cnf
  240.    copy hstnodes.rpt+node56.rpt+private.rpt \pcb\gen\blt15
  241.  
  242. The last line, of course, copies the three separate reports into one single
  243. bulletin called blt15 which is our bulletin #15 which shows system
  244. availability charts for Salt Air.
  245.  
  246.  
  247. Have fun!
  248. =========
  249. Well, the documentation sure ended up being long for such a simple program.
  250. The output files created by SHOWFREE are fairly colorful and should provide
  251. useful information to your callers letting them know when the best times are
  252. to call your system.  And once it is set up it runs itself forever so you
  253. don't need to worry about it again.  So sit back and relax and have some fun.
  254.  
  255.  
  256. As is
  257. =====
  258. No waranties are given on this program.  It is provided as is.  It works on
  259. Salt Air given the configuration we use.  If your system is similar enough to
  260. fall within the requirements mentioned in this documentation then the program
  261. should work fine for you.  There are no guarantees for bug fixes (if any are
  262. needed) or updates to the software (in case of wishlist items).
  263.  
  264.  
  265. History
  266. =======
  267. 06/19/93   version 1.2    Bug Fixes
  268.  
  269.            There was a bug in v1.1 which was modified to accomodate event
  270.            information from v15.0.  The bug created a range of minutes marked
  271.            as "used" between the last caller and when the event ran.
  272.  
  273.            Effectively, the system would appear extremely busy just prior to
  274.            the event running.  This has been fixed.
  275.  
  276.            Also, if the Monitor Missed Connections option was enabled, it was
  277.            not fully counting the time in between the last caller and when
  278.            a "missed connection" was detected.
  279.  
  280. 05/06/93   version 1.1    Operational change
  281.  
  282.            Modified the "minutes used" calculations so that instead of assuming
  283.            a "100% free minute" when the last logoff and next logon are 1
  284.            minute apart, it will now count that minute as not available at all.
  285.  
  286.            Due to the use of $$LOGOFF.BAT files and other processing that must
  287.            occur AFTER the logoff but BEFORE the next login, it was more likely
  288.            to be less than even half of a minute between calls if the two calls
  289.            were only 1 minute apart.  So it does not even attempt to average
  290.            it to 30 seconds or anything.  It just counts the minute as used
  291.            and therefore unavailable.
  292.  
  293.            Also, in v15.0 you can monitor missed connections.  This can
  294.            provide additional information such as when the phone rang but a
  295.            connection was never establish, or when a connection was made but
  296.            the caller never logged in.  By factoring this information into
  297.            the system usage, the system availability is closer to reality.
  298.  
  299.            NOTE:  see the v15.0 section up above for required PCBTEXT changes
  300.            and settings in PCBSetup.
  301.  
  302. 01/11/92   version 1.0    Original Release
  303.